Contexto global

FindByRef

Sintaxis:

FindByRef(<ListaReferencias>, <AreaBusqueda>, <IncluirObjetos>, <ExcluirObjetos>)

Parámetros:

Tipo: Array.
Array con la lista de referencias a los objetos que se deben encontrar.

Tipo: Array.
Define el área de búsqueda de objetos. El área se establece mediante una combinación de separadores que incluyen objetos de metadatos entre los datos en los que se debe realizar la búsqueda.
El tipo del elemento del array es Array.
El tipo del array anidado es el siguiente:

• El objeto de metadatos es un atributo común que separa los datos.
• La cadena es el nombre del atributo común que separa los datos.

El valor predeterminado es Undefined.
Valores permitidos:

• Undefined,
• Array con una combinación de separadores que define el área de búsqueda,
• Array vacío: el área de búsqueda se define mediante los parámetros del método <IncluirObjetos> y <ExcluirObjetos>.

Nota: Si la combinación de separadores contiene repeticiones, se produce una excepción, ya que la configuración puede no tener objetos de metadatos que estén incluidos dos veces en el mismo separador.

Tipo: Array.
Permite especificar directamente los objetos de metadatos que deben estar disponibles en el área de búsqueda de referencias a objetos.
El elemento del array puede estar representado por:

• Objeto de metadatos.
• La cadena es el nombre completo del objeto de metadatos.

Valores permitidos:

• Undefined,
• Array vacío,
• Array de objetos de metadatos.

Tipo: Array.
Los elementos del array pueden estar representados por:

• Objeto de metadatos,
• La cadena es el nombre completo del objeto de metadatos.

La propiedad permite especificar directamente los objetos de metadatos que deben excluirse del área de búsqueda de referencias a objetos.
Valores permitidos:

• Undefined
• Array vacío (no hay objetos que se agregarán al área de búsqueda),
• Array de objetos de metadatos.

Valor devuelto:

Tipo: ValueTable.
Devuelve referencias a los objetos encontrados en ValueTable.
Primera columna: referencia de origen.
Segunda columna: referencia al objeto, si la referencia encontrada corresponde con la tabla de objetos o un valor que representa un registro de una tabla que no es de objeto.
Tercera columna: objeto de metadatos que corresponde a los datos donde se encuentra la referencia.

Descripción:

Busca referencias a los objetos dados en el parámetro <ListaReferencias>.
La búsqueda solo incluye los datos disponibles dentro de la sesión actual con respecto a la separación (también se tiene en cuenta la separación condicional).
La búsqueda incluye todos los datos que pueden contener enlaces a los objetos transferidos. Se produce una excepción si el usuario no tiene derechos de acceso al objeto.

Disponibilidad:

Servidor, cliente grueso, conexión externa, aplicación móvil (servidor), servidor independiente móvil.
Llamar al método ejecuta una llamada al servidor.

Nota:

Si el parámetro <AreaBusqueda> no está definido o si se utiliza el modo de compatibilidad de configuración Version8_3_4 o el modo de compatibilidad de configuración con una versión inferior, la búsqueda se realiza en todos los datos disponibles dentro de la sesión actual teniendo en cuenta la separación (también se tiene en cuenta la separación condicional).
Los parámetros <AreaBusqueda>, <IncluirObjetos>, <ExcluirObjetos> se ignoran en la plataforma móvil.

Ejemplo:

Disponible desde:

Disponible desde la versión 8.3.5.